Skip to content

feat(skills): Add icon-finder skill#12

Open
bekah-stephens wants to merge 1 commit intopatternfly:mainfrom
bekah-stephens:new-icon-finder-skill
Open

feat(skills): Add icon-finder skill#12
bekah-stephens wants to merge 1 commit intopatternfly:mainfrom
bekah-stephens:new-icon-finder-skill

Conversation

@bekah-stephens
Copy link

@bekah-stephens bekah-stephens commented Mar 13, 2026

Summary

This skill closes the loop on icon discovery by allowing your AI agent to search the @rhds/icons ui set (~542 icons) by described use case. It interprets natural-language prompts like "find me an icon for cloud deployment," derives search terms, fetches the live icon list from the Red Hat Icons demo site, and returns matched icons in both a markdown table and a visual HTML preview styled with PatternFly 6. Each card in the preview displays outline and fill variants side-by-side with individually clickable links to the source SVGs on GitHub, along with software-UI-specific context hints to help users evaluate which icon best fits their use case. If the initial results aren't sufficient, a deep search fallback expands to synonyms, related concepts, and domain-specific terminology to surface icons the user may not have thought to search for.

  • Adds new icon-finder skill with SKILL.md containing the full search workflow (use case interpretation, demo site fetch, keyword matching, fill variant detection, HTML preview generation, and deep search expansion)
  • Includes PatternFly 6 CDN-based HTML preview template with responsive gallery layout, clickable icon variant links, and "UI context:" hints per card
  • Includes footer linking to a custom icon request form for cases where no existing icon fits
  • Includes .gitignore to exclude generated icon-finder-preview.html preview artifacts
  • Works in both Cursor and Claude Code with no dependencies beyond a browser
image

Test plan

  • Verify SKILL.md renders correctly in a markdown viewer
  • Confirm skill triggers on expected user prompts (e.g. "find an icon", "search for an icon", "pick an icon for", "icon options for")
  • Run a search (e.g. "find an icon for cloud") and verify the HTML preview opens with PatternFly-styled cards, correct outline/fill variant links, and "UI context:" hints
  • Verify cards link to the correct SVGs on GitHub (/blob/main/src/ui/ for browsing, /raw/.../src/ui/ for rendering)
  • Trigger a deep search and confirm expanded results appear in a separate section below the originals with no duplicates
  • Verify the custom icon request link in the footer opens the correct Google Form

@bekah-stephens bekah-stephens changed the title Adding a new icon finder skill. feat(skills): Add icon-finder skill Mar 17, 2026
- **Linux:** `xdg-open icon-finder-preview.html`

### Cursor

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This section has separate instructions for Cursor vs Claude Code. Skills should be tool-agnostic per the contributing guidelines — a single line like "Open icon-finder-preview.html in the user's default browser" should be enough and lets each tool figure out the right command.

---

# Icon Finder (Red Hat Icons)

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This searches Red Hat Design System icons (@rhds/icons), not PatternFly React components, so pf-react isn't the right home.

Would something like a pf-design-system plugin make sense to you? That could cover design system resources — icons, illustrations, typography, visual assets — and would be distinct from pf-design-tokens (CSS variable auditing) and pf-figma (Figma files). Happy to help set that up if it sounds right.

@@ -0,0 +1 @@
icon-finder-preview.html
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The generated icon-finder-preview.html gets written to the user's workspace, not to this plugin directory — so this .gitignore wouldn't actually do anything. Safe to remove.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants